package com.yupi.yupicturebackend.annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * 权限校验注解
 * 用于方法级别的权限控制
 *
 * @author yupi
 */
@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface AuthCheck {

    /**
     * 必须具有某个角色
     * @return 角色名称
     */
    String mustRole() default "";

    /**
     * 必须具有的权限列表（任意一个即可）
     * @return 权限数组
     */
    String[] anyPermissions() default {};

    /**
     * 必须具有的权限列表（全部都要有）
     * @return 权限数组
     */
    String[] allPermissions() default {};

    /**
     * 是否需要登录
     * @return true-需要登录，false-不需要登录
     */
    boolean requireLogin() default true;

    /**
     * 权限校验失败时的错误信息
     * @return 错误信息
     */
    String message() default "权限不足";

    /**
     * 是否允许匿名访问
     * @return true-允许匿名访问，false-不允许
     */
    boolean allowAnonymous() default false;
}
